home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / GRAPHICS / @FALCON / VIEWERS / MPLAYER.230 / MPLYR_FR.DOC < prev    next >
Encoding:
Text File  |  1996-12-30  |  12.8 KB  |  351 lines
  1. ****************************************************************************
  2.         DOCUMENTATION DE M_PLAYER.PRG Version 2.30
  3. ****************************************************************************
  4.  
  5.  
  6.     Player de fichiers Quick Time (du Mac), AVI (du PC) images et sons,
  7.     FLI/FLC/FLH, GIF (du PC), DL (?), SEQ, PI1+DLT et FLM (de l'Atari).
  8.           Maker de fichiers MOV (images & son!)
  9.                       Maker de GIF animés
  10.  
  11. *******************************************************************
  12. Avertissement:    Changement de résolution Falcon, voir en fin de DOC
  13. *******************************************************************
  14. Avertissement: TT sans carte graphique, voir en fin de DOC
  15. **********************************************************
  16.  
  17. Auteur:
  18.  
  19. TELLO Guillaume
  20. 240 rue Estienvrin
  21. 49260 Montreuil Bellay
  22.     FRANCE
  23.  
  24. Email: gtello@planete.net
  25. tel: (02) 41 38 71 48 (Filtrage d'appels).
  26.  
  27. La dernière version de M_PLAYER se trouve aux adresses:
  28.     http://www.tripnet.se/~mille
  29.     http://www.magmacom.com/~nima
  30.  
  31.  
  32. ******* Shareware **********
  33.  
  34.      Pour vous enregistrer comme utilisateurs, envoyez US$10 (entre 50
  35. et 60 francs, ça dépend) ou  CAN$15, 15DM, 7UKP à mon adresse ou à ma
  36. banque:
  37.  
  38. Banque: Crédit Agricole Anjou Mayenne / 49 Angers
  39.     n° compte: 10434852000
  40.  
  41.  
  42.         PRESENTATION GENERALE
  43.         *********************
  44.  
  45. Possibilités:
  46. ╣╣╣╣╣╣╣╣╣╣╣╣╣
  47.     1) Permet de créer une animation MOV (Quick Time) à partir d'une
  48. série d'images, d'un son éventuel et d'un fichier BATCH de commande:
  49.         - images TGA2 24 ou 16 bits -> compressés en RLE16
  50.         - images IMG ('ximg', 256 couleurs) -> en RLE8
  51.         - sons AVR, 8/16 bits, mono/stéréo
  52.         - sons WAV, 8/16 bits, mono/stéréo
  53.     (voir fichiers BATCH, SLIDSHOW.DOC)
  54.  
  55.     2) Permet de créer une animation GIF 89a à partir d'images GIF 87
  56. ou 89 uniquement.
  57.         - extension M_PLAYER pour le nombre d'images
  58.         - extension DELAY pur le temps entre deux images
  59.         - extension NETSCAPE pour la répétition de l'animation
  60.     (voir fichiers BATCH, SLIDSHOW.DOC)
  61.  
  62.     3) Rejoue 10 types d'animations:
  63.     - *.MOV (Quick Time)
  64.         - images compressées en:
  65.              CVID (yuv compressé)
  66.              RLE1, RLE2 (gris et coul), RLE4 (gris et coul),
  67.              RLE8 (gris et coul), RLE16, RLE24, RLE32
  68.              SMC8 (gris et coul)
  69.              RAW1, RAW2 (gris et coul), RAW4 (gris et coul),
  70.              RAW8 (gris et coul), RAW16, RAW24, RAW32
  71.              RPZA (15 bits)
  72.              YUV2, YUV9, YVU9 (yuv non compressé)
  73.         - son mono/stéréo en 8 ou 16 bits au format TWOS ou RAW
  74.         - synchronisation image/son désactivable
  75.         - son désactivable
  76.     - *.AVI (Video for Windows)
  77.         - images compressées en:
  78.              CVID
  79.              CRAM8, CRAM16
  80.              MSVC8, MSVC16
  81.              RLE8
  82.              RGB8
  83.              YUV9, YVU9
  84.         - son mono/stéréo en 8 ou 16 bits
  85.         - synchronisation image/son désactivable
  86.         - son désactivable
  87.  
  88.     - *.FLI/FLC/FLH (Autodesk Animator)
  89.     - *.SEQ     (Cyber Paint)
  90.     - *.PI1 + *.DLT    (Cyber)
  91.     - *.FLM        (Kinetic Microsystems)
  92.     - *.FLM        (Lexicor)
  93.     - *.DL        (types 1 et 2)
  94.         - images seulement
  95.         - vitesse normale ou maxi
  96.         - affiche en boucle (touche shift)
  97.         (pour les PI1 + DLT, il faut choisir l'image PI1, ensuite,
  98.         le fichier DLT doit avoir le meme nom et se trouver dans
  99.         le meme répertoire: c:\ESSAI.PI1 et c:\ESSAI.DLT)
  100.  
  101.     - *.GIF    (Compuserve, 87a et 89a)
  102.         - synchro ou non avec les delais (version GIF89a)
  103.         - le nombre d'images n'est pas affiché, sauf si
  104.         l'animation contient l'extension M_PLAYER.
  105.  
  106.     - mode 'Pas à pas':
  107.         - visualisation de chaque image (auto ou non)
  108.         - possibilité de sauvegarde au format TGA (auto ou non)
  109.         - en TC seulement (pas en 256 couleurs NOVA ou TT)
  110.  
  111.     - *.BAT (Batch Files pour slideshow):
  112.         - langage très simple permettant d'afficher une série
  113.         d'images (boucles possibles)
  114.         - formats reconnus:
  115.             TGA2 non compressé (vos créations POV par exemple)
  116.             IMG ('XIMG' et 256 couleurs)
  117.             GIF (87a ou 89a, 256 couleurs maxi)
  118.         d'autres formats seront ajoutés par la suite.
  119.         (voir SLIDSHOW.DOC)
  120.  
  121.  
  122. Matériel requis:
  123. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  124.     - Atari TT030:
  125.         - sans carte graphique
  126.         - cartes acceptées:
  127.             - NOVA (256 ou 32768 couleurs)
  128.             - Crazy Dots1/2 (256 ou 32768 couleurs)
  129.             - Matrix (256 couleurs)
  130.             - Cyrel (256 couleurs)
  131.         - un Falcon en mode True Color (32768 couleurs) et plein de RAM
  132.         (Outside accepté! Afterburner 040 aussi, ScreenBlaster, Blow up,
  133.     Centurbo I également).
  134.         - PowerBook sous MagicMac (256 couleurs, pas de son...)
  135.         - HADES 060 (pas de son non plus...)
  136.  
  137.  
  138.             M I S E   E N   M A R C H E
  139.             ***************************
  140.  
  141. Les fichiers
  142. ╣╣╣╣╣╣╣╣╣╣╣╣
  143.     M_PLAYER.PRG    ; le programme
  144.     M_PLAYER.RSC    ; son interface (à mettre dans le même dossier!)
  145.     MPLYR_FR.DOC    ; utile au moins une fois
  146.     MPLYR_EN.DOC    ; doc anglaise (Merci à Dave Brook pour les corrections)
  147.     MPLYR_GE.DOC    ; doc allemande (Merci à Martin pour la traduction!)
  148.     MPLYR_SV.DOC    ; doc suédoise (Merci à Mille Babic)
  149.     MP_ICON.RSC    ; Les icones! (Merci à Julien Chauveau pour leur création)
  150.     HISTORIC.TXT    ; le journal du programmeur
  151.     SLIDSHOW.DOC    ; les fichiers batch, le MOV-Maker, le GIF-Maker
  152.     COMMANDS.DOC    ; les options de la ligne de commande (en mode TTP)
  153.  
  154. Lancement
  155. ╣╣╣╣╣╣╣╣╣
  156.     Soit on double-clique dessus, on passe alors par un sélecteur de
  157. fichiers normal dans lequel on choisit l'animation (MOV ou AVI) voulue (on
  158. peut donner un masque: *.MOV par exemple).
  159.     Soit on tire une animation (MOV, AVI, FLx) qu'on lâche sur l'icone
  160. du programme, il charge automatiquement le fichier en question.
  161.  
  162.     Premier formulaire:
  163.  
  164.     1) la première partie indique le nom et le type de fichier
  165.     détecté (AVI, MOV, FLx,...).
  166.  
  167.     2) le cadre vert donne les informations sur l'affichage
  168. (dimensions de l'animation, nombre d'images) ainsi que le type de
  169. compression. Si on trouve le mot 'Unsupported', cela veut dire qu'on ne
  170. pourra pas voir l'image...
  171.        Si cette animation ne contient pas de graphiques, on trouve
  172. seulement 'No graphics found'.
  173.  
  174.     3) le cadre orange fournit les informations sur le son: fréquence en
  175. hertz, résolution (8, 16 bits) et nombre de cannaux (mono ou stéréo).
  176. L'indication 'Supported' ne tient pas encore compte d'un éventuel problème
  177. de mémoire.
  178.        Si il n'y a pas de son disponible, l'indication 'No sound' est
  179. rencontrée.
  180.  
  181.     4) le bouton 'Play sound' permet d'activer ou de désactiver le son
  182. (si il y en a).
  183.  
  184.     5) le bouton 'Synchronize' permet de synchroniser les images à la
  185. vitesse réelle (quitte à en passer quelques unes). Sans cette option, les
  186. images sont toutes affichées quelque soit la vitesse (plus vite ou plus
  187. lentement que le son).
  188.  
  189.     4b) le bouton 'Max speed' permet de jouer les FLx/SEQ à mesure
  190. qu'ils sont lus à partir du disque sans attente.
  191.  
  192.     5b) Toujours pour les FLx/SEQ, ce bouton propose la vitesse
  193. normale de l'animation.
  194.  
  195.     6) la bouton Informations... fournit des infos sur les auteurs.
  196.  
  197.     7) le bouton 'Go!' lance l'animation selon vos spécifications
  198. (voir 4 et 5) et selon le fichier (on peut choisir 'Play sound' sur un
  199. fichier muet, ça ne le rendra pas sonore!).
  200.     Si "(Alt) Go!" est disponible, en gardant appuyé 'Alt' tout en
  201. cliquant, on bascule dans le mode Pas à Pas (voir plus loin).
  202.     Avec un fichier BATCH, la touche Alt permet de choisir entre
  203. Slide-show et création d'une animation MOV.
  204.  
  205.     8) le bouton 'Cancel' permet d'annuler l'opération.
  206.  
  207. Statistiques
  208. ╣╣╣╣╣╣╣╣╣╣╣╣
  209.     En fin d'animation, une boite contenant des statistiques est
  210. affichée (si l'animation n'était qu'une bande son, cette boite est omise):
  211.     * Total frames:    nombre total d'images
  212.     * Frames displayed: nombre d'images affichées (100% sans la synchro,
  213. parfois moins si l'image a du suivre le son)
  214.     * Total time: temps qu'a duré l'animation (en secondes)
  215.     * Average: nombre moyen d'images (frames) par seconde.
  216.  
  217. Fin du programme
  218. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  219.     Si on est passé par le sélecteur de fichier, après chaque
  220. animation on y revient! Il faut choisir 'Annuler' dans ce sélecteur pour
  221. sortir du programme.
  222.     Si on a tiré un fichier jusqu'à l'icone M_PLAYER.PRG, le programme
  223. se termine automatiquement à la fin de l'animation.
  224.  
  225. Stopper une animation prématurément
  226. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  227.     Il suffit d'utiliser la touche 'Control' (pas de boite STATS)
  228.     Avec la touche SHIFT sur une animation qui boucle (GIF par
  229. exemple), l'animation se termine à la prochaine boucle et ouvre la boite
  230. de statistiques.
  231.  
  232. Mode Pas à Pas
  233. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  234.     ** selecteur de fichier **
  235.  
  236.     Un sélecteur de fichiers apparait vous demandant de choisir le
  237. dossier dans lequel seront sauvées les images TGA. Le nom par défaut des
  238. images est:
  239.     FRM00001.TGA (ceci laisse la possibilité d'obtenir 99999 images à
  240. la fois).
  241.     Si vous désirez personnaliser, vous pouvez spécifier jusqu'à 3
  242. caractères dans le champ 'Nom du fichier', ils remplaceront 'FRM'.
  243.  
  244.     ** Mini menu **
  245.  
  246.     Le nom du fichier ainsi que les options s'affichent en haut à
  247. gauche:
  248.     (S) save: sauvegarde l'image en cours sous le nom spécifié
  249.     (A) all : sauvegarde automatique de toutes les images à partir de
  250.     celle en cours: arrêt avec la touche Control.
  251.         (lors d'une sauvegarde, un son de cloche signale une
  252.         erreur d'écriture: disque plein ou autre...)
  253.     (Q) quit: met fin au mode Pas à pas
  254.     Esc    : comme 'Q'
  255.     (R) run : avance automatiquement jusqu'à l'appui sur 'Control'
  256.     Autre   : toute autre touche permet d'avancer d'une image.
  257.  
  258.     ** images obtenues **
  259.  
  260.     format TGA 2 non compressé, header de 18 octets:
  261.     Long $00000200
  262.     Long $00000000
  263.     Long $00000000
  264.     Word largeur    (octets inversés)
  265.     Word hauteur    (idem)
  266.     Word $1820
  267.     Viennent ensuite les points rangés par ligne avec 3 octets par
  268.     pixel: Bleu/Vert/Rouge.
  269.  
  270.  
  271.         Q U E S T I O N S   D I V E R S E S
  272.         ***********************************
  273.  
  274. Programmé en quoi?
  275. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  276.     Le programme est entièrement en assembleur 68030, développé avec
  277. ASSEMBLE de chez Brainstorm.
  278.  
  279. Les fréquences
  280. ╣╣╣╣╣╣╣╣╣╣╣╣╣╣
  281.     Les fichiers PC ou MAC ont des fréquences qui sont souvent
  282. 11025Hz, 22050Hz et 44100Hz (ou à peu près, j'ai toléré un écart de 2%).
  283. Le DMA de l'Atari ne comprend que 12517Hz, 25033Hz et 50066Hz. A chaque
  284. chargement du son je le convertis pour l'amener aux fréquences voulues (en
  285. fait tous les 8 octets je répète le 8ème, avec la correspondance 8->9 on
  286. obtient une très bonne approximation des valeurs de l'Atari.
  287.  
  288. Les plantages
  289. ╣╣╣╣╣╣╣╣╣╣╣╣╣
  290.     - Metados 2.70 tourne (problèmes avant)
  291.     - Bug Extendos corrigé (V1.36 et +), un grand merci à Yu-Ou Wang!
  292.     - Bug Turbo-Veille corrigé (V1.36 et +).
  293.     - si l'image est plus grande que l'écran (j'ai fait peu de tests de
  294. dépassement pour ne pas ralentir l'affichage), il se peut qu'on obtienne
  295. deux bombes. Dans ce cas, essayez un écran virtuel (une fenêtre de 320x240
  296. sur un écran de 640x480). Avec la carte NOVA, le problème ne se pose pas
  297. (on dispose d'un mode 640x480x32768 avec les plus nuls des VGA 14").
  298.     - Bug Freedom corrigé (V2.05)
  299.     - FPATCH2.PRG peut résoudre un éventuel problème de son sur
  300. Falcon.
  301.  
  302.     Merci à:
  303.  
  304.     - Pascal Ricard de Pierrevert    (Falcon 4Mo)
  305.     - Julien Chauveau de Méron    (Falcon 4Mo)
  306.     - Hervé Piedvache. de Paris    (Falcon 4Mo)
  307.     - Dave Brook Stony Stratford/GB    (TT 20Mo + Crazy Dots2)
  308.     - Magnus Kollberg de Suède    (Falcon 4Mo)
  309.     - Martin Rothaemel d'Allemagne    (TT 8Mo + NOVA)
  310.     - Yu-Ou Wang de Paris        (Falcon 40MHz)
  311.     - Oliver Skelton de G.Bretagne    (Falcon + BlowUp Hard 1)
  312.     - Jacobo Morro d'Espagne    (Falcon)
  313.     - Rémi Vanel de Seynod, France    (Falcon)
  314.  
  315.  
  316. *******************************************
  317.     Changement de résolution sur Falcon
  318. *******************************************
  319.  
  320.     Le programme passe en True Color pour afficher une animation, si il
  321. n'y était pas avant. Je ne garantis pas la sécurité de cette routine, je
  322. ne rembourse pas les moniteurs explosés (elle a été testée avec succès à
  323. partir des modes 16 et 256 couleurs, elle ne tourne pas dans certains cas
  324. à partir du monochrome ou de 4 couleurs).
  325.  
  326.     Le seul moyen d'éviter cette bascule est de lancer le programme en
  327. TC.
  328.     Si vous entendez systématiquement un bruit désagréable lors du
  329. changement venant du moniteur, le mieux est d'éviter la bascule. Si votre
  330. moniteur ne bronche pas, (genre Multisychro 17"), alors faites comme bon
  331. vous semble.
  332.  
  333. *******************************
  334.     TT sans carte graphique
  335. *******************************
  336.  
  337.     le programme bascule en 320x480x256 pour jouer les animations. Si
  338. la hauteur le permet, l'animation est doublée pour corriger les
  339. proportions, si l'animation dépasse 320 points de large, elle est réduite
  340. de moitié. De ce fait, toute animation jusqu'à 640x480 est acceptée.
  341.     Les limitations sont celles des modes 256 couleurs:
  342.     - animations 16bits ou TC jouées en gris
  343.     - animations 256 couleurs ou moins jouées en couleurs
  344.     - pas de mode pas à pas
  345.  
  346.     L'affichage est bien plus lent que sur une carte graphique
  347. puisqu'au lieu d'écrire directement en mémoire vidéo, on écrit dans un
  348. buffer qu'on recode bit par bit vers la mémoire video.
  349.     Pour les animations du monde Atari (SEQ, DLT, FLM) et les DL, une
  350. routine adaptée au mode TT est présente, de ce fait, on retrouve une
  351. bonne vitesse d'affichage.